home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-14 / adcac122.zip / ADCACHE.DOC < prev    next >
Text File  |  1990-02-24  |  7KB  |  142 lines
  1.                             ADCACHE - EMS HARD-DISK CACHE
  2.  
  3.  
  4.           NAME
  5.                adcache - the awesome disk cache
  6.  
  7.           SYNOPSIS
  8.                adcache [-12fhinsu] [-a#] [-e#] [-r{#|+}] [-w#]
  9.  
  10.           DESCRIPTION
  11.                ADCache is a TSR hard-disk cache that uses EMS memory.  It
  12.                requires EMS version 3.2 or better and MS/PC-DOS 2.0 or
  13.                above.  ADCache is small and fast.  It works on any IBM
  14.                PC/XT/AT or PS/2 or compatible with one or two hard disk
  15.                drives that use the BIOS INT 13h interface.
  16.  
  17.                ADCache is shareware.  Please read "Licensing" at the end of
  18.                this document for details.
  19.  
  20.           OPTIONS
  21.                In option descriptions, the symbol "#" stands for a decimal
  22.                number.
  23.  
  24.                This option is always available:
  25.  
  26.                -h   Print a usage message describing ADCache's command-line
  27.                     options.  Does not install the cache.
  28.  
  29.                These options are available only when installing ADCache:
  30.  
  31.                -1, -2
  32.                     Cache only the first or second hard drive.  By default,
  33.                     ADCache caches both drives (or drive 1 if only one is
  34.                     installed).
  35.  
  36.                -i   Place the cache index in EMS.  Normally, the index is
  37.                     kept in conventional memory.  Placing it in EMS may
  38.                     slow access, but reduces the amount of system memory
  39.                     required.  Using "-i" allocates 16K of EMS to the
  40.                     index.  This is less effective with a small cache, as
  41.                     ADCache requires only 1 to 2K of index per megabyte of
  42.                     cache.
  43.  
  44.                -n   Do not use 32-bit transfers.  Normally, if ADCache
  45.                     detects that it is running on an 80386 processor, it
  46.                     will use 32-bit instructions to transfer data in and
  47.                     out of the cache.  This option forces it to use 16-bit
  48.                     instructions compatible with the 80286 and earlier
  49.                     processors.
  50.  
  51.                -a#  Allocate all but #K of EMS to the cache.  This option
  52.                     will leave the specified amount of EMS available for
  53.                     other programs.  Use either -a or -e but not both.
  54.  
  55.                -e#  Allocate #K of EMS to the cache.  The default is 512K. 
  56.                     The actual amount of EMS used may differ from the
  57.                     number given by several K because of rounding of block
  58.                     sizes.  Values may range up to 32768 (32M bytes), but
  59.                     varying limits on the sizes of internal data structures
  60.                     may restrict the amount of memory that can be used.
  61.  
  62.                -r#  Enable readahead when filling the cache from disk.  Up
  63.                     to # additional sectors are read and cached beyond the
  64.                     number requested.  The default is approximately 1/4 of
  65.                     a full track.
  66.  
  67.                -r+  Enable readahead and set the readahead length to one
  68.                     full track.
  69.  
  70.                -w#  Enable delayed-write caching where # is the time in
  71.                     seconds that data are held before writing to disk.  The
  72.                     legal range of values is 0.0 to 60.0, with an optional
  73.                     decimal point followed by one digit for 1/10 second
  74.                     resolution.  Selecting 0 (or omitting the number)
  75.                     delays writes by 0.2 second, long enough to catch most
  76.                     multiple writes to a single track.  Delayed writes are
  77.                     off by default.
  78.  
  79.                These options are available only after installing ADCache:
  80.  
  81.                -f   Flush the cache.  This option forces ADCache to flush
  82.                     all delayed-write data in the cache to disk.  It does
  83.                     not invalidate the cache.
  84.  
  85.                -s   Display statistics on cache hits and misses.
  86.  
  87.                -u   Uninstall ADCache.  This function attempts to remove
  88.                     ADCache completely from memory, but that may not be
  89.                     possible if other TSRs have been installed afterwards. 
  90.                     In that case, it disables the cache.
  91.  
  92.           LIMITATIONS
  93.                ADCache requires that all drives being cached have the same
  94.                number of sectors per track.  If you have two drives and use
  95.                a controller with sector translation, you can only cache one
  96.                of the drives if they are not configured for the same number
  97.                of sectors.
  98.  
  99.                ADCache caches hard disks only.  It does not work with
  100.                removable-media drives.
  101.  
  102.           BUGS
  103.                ADCache will not work correctly with EMS emulators.  It will
  104.                crash horribly if used with a disk-based EMS emulator.
  105.  
  106.                "Awesome disk cache" is a stupid name.  Please send me
  107.                suggestions for better ones.
  108.  
  109.           COPYRIGHT
  110.                ADCache and this document are copyright 1990 by:
  111.  
  112.                     David H. Rifkind
  113.                     1800 W. Hillcrest Dr., #287
  114.                     Newbury Park, CA  91320
  115.  
  116.                     BIX: drifkind
  117.  
  118.           LICENSING
  119.                ADCache is shareware.  You may use it and give it to others
  120.                to use as long as you include this document and charge no
  121.                fee other than reasonable distribution charges.  You may try
  122.                ADCache without paying for it, but if you continue to use
  123.                it, you must pay for it.
  124.  
  125.                To pay for and register your copy of ADCache, send $15 U.S.
  126.                by check or money order to the author at the address above
  127.                ($10 per copy if registering multiple copies).  Include your
  128.                name and address and the version number of ADCache displayed
  129.                when you run the program.  If you pay an additional $5, I
  130.                will send you a copy of the next upgrade (or the current
  131.                version if you register an older version).
  132.  
  133.                This is a single-user license, but may be applied to more
  134.                than one computer as long as only one copy of ADCache is
  135.                running at a time.
  136.  
  137.                Site licenses are available.  Contact the author for more
  138.                information.
  139.  
  140.           ADCache version 1.20
  141.           Last update: February 19, 1990
  142.